MASTERFILE 


A BUSINESS’ DOMESTIC 
FILING SYSTEM 


FOR 48K ZX SPECTRUM 
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OVERVIEW 


MASTERFILE is a filing and retrieval system for use with the 48K 2X Spectrum. It is 
almost entirely machine-coded for compactness and speed, and offers about 22k of date 
ger file. Files can be saved and loaded independently from the program, and red 
either on cassette or Microdrive cartridge. Because MASTERFILE cealeg forma are 
user-defined, the range of applications is enormous, both for domestic use and for 
business. Address lists, library catalogues, personnel files, stock inventories, schoo! 


exam results, family trees - all these are easily handled by MASTERFILE, 


Some of the main features of the program are... 


~ Menu-driven 

- Dynamic variable-length file 

- Jser-defined data names and report formats 
- Sequence by any data type 

- File search by any number of criteria 
- Display 1-22 records per screer 

- #rint to the 7X Printer 

~ Total /average 

- ‘ipdate, Copy, Erase any record 
Save/Load files, save progr as 

- Optional User Basic Interface 

- Microdrive compatible 

- Very fast in operation 


GLOSSARY OF TERMS 


ADD Insert a new Record ontce the end of the File, 

ARGUMENT In search mode, something with which records are to be compared. 
AUTO-FROMPT where new data items are solicited automaticall;. 

BACK QUT Change one’s mind 

COMMAND MODE where cursor is flashing K and awaits line number or Basic keyword, 
DATA NAME Legend associated with a data reference, 

DATA REFERENCE Letter A-Z by which data items are identified. 

DISPLAY MODE where selected records are viewed in a Report. 

EDIT NODE where Report tormats are created/altered. 

EMPTY FILE one devoid of records, data names, report formats. 

FILE Collection of Records, and associated Data Names and Report Formats, 
GENERAL © Overall} attributes of a Report, 

INVERT Flip select status of all records. 

ITEM Data, 1-128 characters in length. 

LITERAL TEXT Static text, e.g, a heading, in a report. 

MAIN MENU The menu offered when the program is loaded. 


MENU List of key options. 

HF Abbreviation for MASTERFILE, 

MM or mm: abbreviation for Main Menu. 

NULL TEXT legend shown in a report in the absence of an iten. 

PAD Fill out data with spaces in a report. 

PROMPT Instruction to the user, or small menu, 

PURGE Erase all selected records. 

RECORD Collection of up to 26 items. each with a different Data Reference, 


AEPORT Disolay of selected Records, 

REPORT ELEMENT A part of a report, e.g.heading, box. data spec. 
AEFORT REFERENCE Character 0-9,A-7 identit Report. 
RESET Clear select status of all records 

SEARCH MODE where records are sel 
SELECTED Eligible for display i 
SEQUENCE why s are List 
UPDATE MODE where a record can b 
USER BASIC Basic which you can supply ¢ 


ise by comparing with an Argument, 


ing order by one item. 


FILE STRUCTURE 


A file is an organised collection of data which is stored on cassette or cartridge, and 
which can be lcaded into RAM for enquiry or update purposes. It could be simple like a 
telephone list, or complex like a personnel data file. But in every case, a file is 
made up of records, each of which is usually related to a particular identifying iten,, 
3.9. a person, a recipe, a part number, Each MF record is in turn made up af up to 26 
different items of data, e.g. name, address, telephone number, stock level. Data item: 
are all treated by MF as being of variable length, up to 128 characters long. There is 
ne rigid record Avatars and items can be stored in any order within a record; for 
this reason, items are tagged with a data reference letter. & record cannot have more 
than one of any data reference; this is an important limitation tc bear in mind when 
designing the structure of your file, All data is stored in character format. 


One of the many ae ateSteS of a computer file over a card index system is that you car 
sort it into any order. AF does not actually sort your file, but instead lets you view 
it in any sequence you choose. And you can have different logical views of the same 
data, in different sequences, a feature normally seen only in large computer systems. 
Further, you can be selective about which items are required in a report, and you 
choose the display style. You will compose a report format for each view of the file 
mie you need, Once the formats are built, they are saved automatically as part of the 
Tlie. 


While items are referred to using a single letter, you can associate a word or phrase 
with each reference letter, which MF then displays whenever you use data references. 
‘Especially in Auto-prompt, q.v.). We call these data names, and these names are also 
stored automatically as part of your file, 


MENUS, PROMPTS, MODES 

MF menus are yellow and respond to upper-case or lower-case keys impartially. When MF 
is loaded, it presents the Main Menu (mm), The mm screen also displays the File Name 
‘up ote {4% characters) and the MF version number. When a valid menu key is used, MF 
either takes the indicated action, or immediately offers another menu or prompt. & 
arompt is a one-line instruction or menu in the lower part of the screen, and takes 
priority over au other menu. All the yellow menus and prompts respond to just a single 
apy, But where MF requires a textual response, the flashing | cursor appears and you 
terminate your response with the ENTER key, 


MF nearly always offers a menu or prompt, but there is one exception: when in Display 
mode the menu would obliterate your display, so itis not usually shown. But you can 
overlay your display with the menu, by using the 9 key - and use @ again to remove the 
menu. 


MF operates in a variety of Modes, usually shown by a blue heading. { But not display 
mode - we leave lines 0-21 to you. Display mode always shows "Report n" in red on line - 
22.). The important modes are described in the Glossary, and some modes - Search, 
Display, MM - are accessible by several menu routes, 


It would be a little dangerous to allow a single-key response to erase data, so MF 
always asks confirmation via the Y key. Likewise, User Basic is potentially drastic, 
and again requires Y to confirm. If you see "Y to confirm” you can back out with any 
key except %. 


BASIC COMMAND MODE 


dith afew exceptions, MF runs under machine code control and the BREAK hey 1s 
ineffective. But i/ you need to adapt the Basic (e.g, for Microdrive) or if you need te 
aut in your own User Basic, then you must get into Command Mode. This can be done only 
when MF offers a flashing L cursor, €.9. press L at mm. If you then respond with CAPS 
SHIFT held down and 6 , you get "H STOP in INPUT etc" and now you are in Command Mode 
and can list and alter the Basic. 


To resume MF orocessing, give the command "G0 10 i", which takes you to the main menu 
again, 60 T0 1 should also be used te recover any accidental drop into Command Mode. De 
not CLEAR or RUN, since these will cause MF to fall. 


GETTING STARTED 


four MF cassette contains two identical recordings - either consecutive, or one each 
side. Each recording is in two parts... 


‘a) Program: MF 
(b} Bytes: MF mcode 


Part (a) is in Basic, and includes the example tile. Before loading MF Basic, remember 
this first vital step... 
CLEAR 53 57036 


Now you can load the program, using... 
LOAD "" oor LOAD "MF" 


nce loaded it automatically ioads part (b), which 1s about Sk of machine coded MF 
logic. Just leave the cassette playing until mm appears. 


The reason tor the CLEAR 3 s to re the top Sk of RAM for the MF machine code. 
We cannot put the CLEAR into the RF because that would erase NF key variables, 
including F$ which contains the file. MF will not work if any other interface software 
has to use RAN above SE S 7OSG 


MAIN MENU OF TIONS 

The main menu represents the top logical level of processing and offers functions which 
affect the file as a whole, Some functions are described more fully elsewhere. 

4. Add a new record onto aa ipl of the file. & one-byte record is inserted, and you 
Cc 'R and ' increment, HF is then in ADD RECORD made, gq... 


heading of each report, You can 


all report references, together with top-most hi 3 
ence of your choice, or you can use 


skitch to Display mode by pressing the report refer 
ENTER to return to am. 


id 


ia) 
ia) 


D Switch to Display mode to view Selected records. The report format used will be 
either the first one created, or the last one used, If there are no report formats yer, 
fdit mode is entered, Seyeral other menus offer a ) opticn. See DISPLAY MODE, 


E te renort formats, See EDIT MODc. 

. Load a file which has been saved vie am \ F etc, See LOAD AND SAVE, 

N See DATA NANES. 

$3 Switch te Search mode to identify records according to the values of data they 
contain, See SEARCH MODE, 


unselected, which will show "Sel= 


fis with all erasures, confirm with the ¥ 


LOAD AND SAVE 


Uo Process all selected records via User Basic, See USER BASI 
GOP TYWRILE 


ould keer a version of MF which fas an em 
rt anew file applic te Four 
ile, as follows... 


we 


ty file, and use it whenever you need 
mpty fire, you must clear the example 


fa) Erase all records; mm RIF + 


b) Erase all report formats: mm E, Then Rt X Y which erases report format 1, Then f 2 
xy te erase report 2, and sc on for 7,4, Then M back to ma. 
c) Erase all data names: mo N, then E ¥, E ¥, etc until so more cata names are 


. Then Hoback to me. 


the program, via mi J F EMFTY etc, This also grovides ie with an additional 
poof the program, You ma wish ve the empty file by itself, via am 
EHETY etc. Note that an empty il] contains essential system information wi 


Fe, 


DA TA NAMES 


- although not essential - to give each of your data references a name. 
up to 128 characters in length, and are stored part of the file. 
ential if j jou wish to use auto-prompt when adding new records. Use ma N to 
review or alter i data names, You will see the same menu as appears in Add a Record, 
out opt Fand P do not function, Use 4 to add a new data name, N to browse through 
names, F to replace aname, — to erase a name. Use M or 2 to return to mm. The 
ander in which you add data names determines the order in which data is auto-prompted. 


EDIT MODE 

sla Mi £, Edit mode is concerned with the creation and modification of re 
. Up a report formats may be detined, ing that many logical views of 
selected records. Some effort is required to edit a report format, but this 
typically 2 an ce-only task, 


The menu reached via mm E invites you to create anew format (A) or review/alter an 
existing format (R). You can also return to mm (Mi, 


After Aor Ry give the report reference, ¢-Z, as prompted. The report reference "Ref n" 
is then shown in red at top right while in Edit mode, 


When a report format is first created, 


t is given the following "General" 
characteristic 


3} Background paper colour of 7 (white) 
Screen border colour of 7 
equence ~ none. unsorted 
a) Interval of one record ever, 2 lines 


c these at any time just by using menu option F whilst “General” i 
displaye are then prompted for a) to di. Reply to a) and “hl with key O-7, 
toc} w the data referenc the data by which the report is te be sequenced, a 
else ENTER if no sequence is required, Repiy te d) with 1-22, being the interval dows. 
the screen at which records are displayed. 


Soh 


To show just one record per screen, use an interval of 22, To list one recoro ever; 
line, use an interval of 1. 


some feport cleme: 
report. There 15 4 
more than once, Use Edit menu option aA to Ae a 
what kind of element being added, all 

2 ements are static, and will always appear whether any records a 
hey are... 


i 

nt, whereup 
except dats 

cted or not. 


L citeral - e.g, title, column neading, currency symbol. 
B Box - a feta : drawn to pixel resoluticn, 

H Horizontal line. 

¥o Vertical line. 


For a Literal, press L and supply the data as prompted... 

Line number, column, Paper, Bright or not, Inverse or not, Flash or not, and the 
literal text. If text overflows column 21 in the report, i will resume next line, 
column 3, Ink colour is not prompted - NF always uses contrast, 


For a Box, pres 
is 


c? nd supply as prompted the co-ordinates of the top-left corner, 
depth in pixe 5 ess i, 


less 1, width in pixels 1 
For a line, press H or V and supply as prompted the leftmost or topmost pixel, and the 
length in pixels less i, 


So much for the static elements - now we consider the data elements. Data elements 
specify which items of a record are to be displayed, where, and with what attributes, 


jay pressed A to add an element, press f and reply to a quite long list ot 
prompts... 


a) Data reference of the care item. 

b) Line - the line at which the first selected record is to display the item. 

c) Column 

di MF lets you display data in any character rectangle, and so you are prompted for... 
Width - number of columns wide, and... 

2) Depth - number of lines deep. 

f) Spectrum attributes Paper, Bright or not, Inverse or not, Flash or not. 

gi Pad or not; Pad will fill the rectangle with the chosen paper colour. 

a) Null texts if data is absent in arecord, then you 
place, e.g. “not known", or "-". The default mull text is a single Space, 


to appear in its 


Gent data will be shown right-justified, provided that the field depth is 1, and 
fad=h. ‘ 


The above fully describes how an item of the first selected record appears in 
t, Items from further records will be displayed lower down the screen, 
s af whatever interval you have in “General”. 


browse through your report elements by weing H ("Next element"), and any 
can be replaced by using fF and then following the promts, There is also an 
element erase option, &. You can go straight to Display mode via D, to see the result 
of your changes. 


The report format as a whole can be erased using %, or copied using C, Copy is very 
useful when you want to build a report similar to one already built; perhaps you just 
want the same layout but different sequence. After C or X% you see the inital Edit menu, 


fin interesting use of Null Text is to use an un-used data reference in a data element 
is how we get the dashes lines between records in our example file, The null t 
is aline of dashes, and always appears because the target data reference is never 
present in the records, 


Plan your report iets on paper before coding them. Aim for an exact number of 
records per screen, by eka suitable line numbers and interval. Beware overlapping 
elements, or overlapping records - MF does not check for these. 


ADD A RECORD 


The usual way to add anew record is via mm A, which builds an empty record onto the 
end of the file. The menu then invites you to add (insert) an item (A), Auto-prompt 
items (P}, or it to Display mode (D) or to mm (M). Other menu options are shown, but 
are not immediately applicable. 


To put data into anew record, you can use A and supply the data reference and the 
text. The text is a maximum of 128 characters, and trailing spaces are dropped. No 
tokens, graphics, colour controls, are allowed - they get altered to 7 if entered. CAPS 
SHIFT/LOCK may be used, The item is displayed in bright white under its red data 
ref/name. 


an alternative method of data entry is via (F), which 1s Auto-Prompt. This causes MF to 
solicit each item by scanning your data names, Auto-prompt obviates the need to 
ramember all your data references, and also makes it unlikely to omit an item. You just 
enter ¢ ENTER, for each prompted itenm. MF briefly displays it before prompting the 
nect item. 2f vou have no data for an item, just use ENTER, ENTER quickly followed by 
SPACE will end the prompts. 


4aving added one or more items. you can browse through them for checking, using Nest 
Item (NJ, And you can replace using R, or erase using &. Instead of holding the N key 
down to reach an item, you can summon it directly using the & key followed by the 
target data ref. But if you attempt to 6 an item which 1s not present, MF waits for you 
to dive a different ref, or back out via ENTER, 


It you 


e {R} by mistake, and wish to back out, just delete or blank your 
reply an 


ER, MF will leave the original item intact. 


Befor you can add another record, vou must first go back to mm (M), 


5 y to insert a record at a particular place in the file - using Display 
mode COPY, See DISPLAY MODE. 


10 


DISFLAY MODE 


Display mode is where you view your selected records in a way dictated by one of your 
report formats. You can display via mm D, but there are many other menus which offer 
the same ) option. The report format used is that which was last used, or else the 
first format. Another way to Display mode is via mm C where you choose a report ref. 


The contents of lines 0-21 are dependent upon your report format - you have a free hand 
here. Line 22 shows the following... 


Report n Q-menu No more 
redi (yellow) (bluel 


where “n" is the report reference, and the blue legend can be "., more" when there are 
more records to be displayed than {here is room for on the current screen, 


fince line 22 is displayed - some sequenced reports can take a few moments to fill the 
page - a list of menu functions is available, The menu is not shown as a rule, but you 
tan summon it with @ - and banish it again with @, The functions are as follows... 


N14 ",, more" is shown in line 22, use N to see the next page of the report, 
the report by 1-? records. Sorry, we do not have a “back i" function, so 


e 
not to overshost. Use 1-9 to position a record at top-of-screen ready for 
fE/O/C below. 


E Resume the report from the first record. 


y lines 0-21 to the 2X Printer, or equivalent. Use the S (Single) to print just 
current page. Or, use A {All) to print the current page and all further pages. To 
abort a print, use BREAK and 60 10 1. 


U Enter UPDATE mode with the top-most displayed record. If Display mode is resumed 
from Update mode, the same target record is shown, 

E Erase tep-mest record, ({Y to confirm) 

5 {Letter "Oh") un-selects the top-most record, The record is not erased, 


Ci Copy the top-most record. A mew record identical to the top-most record is 
inserted next to it, The copy record can now be altered via U etc, and so here we have 
a means of inserting a record at a particular place in the file. 


3 Enter Search Mode. 


i Compute and display total /average, 


Swite h to a different report format, resuming at the same top record as currently 
Higateren You are prompted for the new report ref, and so it just needs two keys te 
switch from one report to another. The reports need not be in the sane sequence. This 

is part) y useful to switch from a summary report { say 20 records per 
(1 record per page } of the top record. 


i - gress @ again before doing anything else. 
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WORD FROCESSING 


dhen data is disolayed via Display mode, MF performs rudimentary word-orocessing such 
that leading blanks are ignored, a clean left margin is maintained, and word-breaks are 
minimised. This means that text can be entered without haying to worry about spacing. 
MF will start anew line rather than split a word. unless the last line is alread. 
reached. 


“he vertical line character ‘VLC) has a special use in MF. A VLC is found via Extended 
node symbol ~shi ft S, i.e. the little red mark under the $ key of the Spectrum kevboarc, 
"he VLC is a force-line-break signal, so you use it in an address for example. You key 
the text as a eter data item but with VLCs as line separators. Now when the data i: 
displayed in a 4-line block, for example. each VLC forces a change of line. This is 
ideal for address labels. 


Notice that when in Update mode, item data is shown without word-processing, and LCs 
are visible. But in Display mode the VLCs do not appear. 

fficient room to display an item. truncation occurs on the screen, 
d 

d 


Tf there is insuffic 
1] data is kent in the file, 


Le 
although the full 


UPDATE MODE 


“his mode is where a record can be updated. i.e, its reviewed, 
replaced. or erased, and new items can be added. The ta te is always 
the ton one displayed in Display mode. Indeed. update lly only be reached 
from Display mode, with at least one record displayed, 1-2 keys to position 
the target record at the ton of the screen, then oress WU. Now your options are almost 

mz and prompts are 


identical to those described in ADD A RECORD, and indeed the same me 
offered, The difference is that vou can use 2 to resume Display a 
record on completion of the update, 


t the same target 
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EXERCISE 


Here is a short exercise showing how to set up a simple file of names and telephone 
numbers. starting from an empty file. Follow the steps described in EMPTY FILE before 
We shall use the following notation... 


"i 


nt the brackets or their contents) 

Follow this. exercise exactly, and slowly - taking note of every menu and prompt, Start 
at am of the empty file. We show the menu responses in CAFS but you can use unshifted 
keys. Here we gc... 


NANnameftATtel number¥M (This defines two data names: "name" for data ref N, and "tel 
number" for data re¢ 7, Now we will add some records...) 

aaNJones PEATOL-234 Sh7BIM = We have stored one record, with the telephone number of 
oH for another record.. 

S554i (This ie we used auto-prompt to enter the data for R. Atkins. 


APSmith Johnt 
APAirportt01-BB? 22 

aPHairdresser $274-S4324H 

We now have 5 records, and now we must use Edit mode to compose a report format so we 
can View our file...: 

SAL (start of report ref t) 

SEBHLYNNTelephone-List¥ (Puts a heading "telephone-List" in blue at line 4 column 


8 

ADNEHLELESL47YNNNE (To show names starting at line 3, col 1, 16 characters max, 1 line 
deep. paper white, bright, inverse no, flash no, pad no, no null text.) 
QDTSE194144192YNNN---* (To show tel numbers starting at line 3, col {8, 14 characters 
max, | line deep, paper red, bright, inverse no, flash no, pad no, null text of "---",) 
‘We can now test the report by going to Display mode...) 

(Looks Qk. but how about sorting it by name ? and a few other changes. Go back to 


white, border set to yellow. sequence by N, interval to 
(Now We have described a box. See the effects of these changes 


5 (Hey oresto, the display is sorted by name - see why it is best to olace initials 
after surnames ? - and note the border and interval changes, Now reset interval to 2 
and finigh off with some fancy stuff...) 

MER (Review report ae Ween 
FEN? f. 


Sra ee aa 4! (We have used data ref 2 which is 
dashes, See the effect...) 

et us update Jones - his sumber has changed...) 

Jones at the too! 

ko update mode) 

(get telephone number 

{4D {replace with new data, fae to Display mode.) 

we can take a save of the file.. 


further - edit more report formats, update the file, explore 
no menu aption untriec. 
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SEARCH MODE 


He have seen that mm F I will make the whole file available for Display mode viewing, 
But when a file is very long then it becomes more useful to let the computer pick out 
just those records which you need. Search mode does this, and very swiftly, b 
at a particular item in each record and comparing it with an Argument which 
Hecords which qualify are flagged as Selected and are reflected in the =nonon® 
value, To start a search from atch, vou would ensure that no records are selectec 
initially. Use mm F to set Sel= 0. Now use mm $ to start the search dialogue, 


The first search menu invites A (All) .or L (Sel) or M (mm), Use A to search alt 
anselected records, and select those which match. Use L_ to search only those records 
already selected, and unselect se which do not match, The use of & will increase the 
"Sel=nnnnn” count if any unselected records match. The use of L will decrease the count 
i selected records fail te match. 


Yaving pressed Aor L. you are then asked for the data reference of the items to be 
compared. Press the corresponding key. or back out via ENTER, 


The next menu asks whether the data is to be treated as character 
Numeric data is normalised in flight to NNNNNNNNNNN 
a0 1° for the ourpose of fhe comparison. 


(C} or numeric (N), 
8 is treated az 


The next menu asks for the type of comparison, and a 


here is the word "GLUES", Note that & (Scan) only or 
is C, denoting character search. 


finally, vou are asked for the Argument - i.e, the value with which the target item 
are te be compared, If vou have chosen numeric treatment, then the argument must b 
cumeric too. 


MF then resnonds by updating the 
from which vou can refine the search further. a 


unt and re-offering the too Search menu, 
sit to an or to bicplay mode, 


Now let us in more detail the comnariscn nyoce 
meaning a iE lf-eyident. we hope. i 2 ve 
item presen then the comparison is deemed to fail en if the comparison ty 
(unequal). i a record is met with non-numeric target item, then the search ha 
the prompt "Non-numeric data:Skin for) Update", Press $ to ignore the record, 
oe ae mode at that record, If vou choose U then the search cannct be 
irectly. 


Gharacter search is 2 Litt 
are co ed equal for 
he gurpose of sequence in 
item i in the record, Sut 2 
aoual, Thus searching for items equal 
_ "fred", "Freda". If “the araunent 
rever considered equal, Arecord with "FRE" wi 
argument, 


2 fore invo 


2 
b 


tle 
the 
Dis 
qt 


Character scan 
zraunent paasitls 
Epadal 
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There 1s a way to search based upon the presence or absence of an item, regardless of 
value, since an absent item is considered to start with binary zero, Thus a 
acter search with argument * (" (note the leading blank) will differentiate records 
the item from those without it. Use comparison type L to select those records 
ut the item, and G to select those with the item. 


We have chosen the search menu letters so that with practice you will soon make 
searches without aven looking at the menus. Your search parameters are listed on the 
screen to remind you what you entered. You can reach Search mode directly from Display 
mode, 35 well as from mm, 


ye finish this chanter with a short example of a three-oass search, which you can use 
on the Example file. We will search for all records where Salary is between 14000 and 
{5000 and Department is Admin. Using the same notation as in the EXERCISE earlier, we 
start at an... 


PSASNGL4 igives us everyone with Salary over 14000) 

LSNL 1500: {keeps only those with Salary below 15000) 
LOCEadmt {keens only those with Department starting "adm") 
I (Display the selected records.) 

TOTAL/ AVERAGE 


MF can compute and display the total and average of numeric items of selected records. 
As with numeric search. the data is normalised in flight, ignoring any decimal places 
second. The total is Sele ae with most leading zeros suppressed. Any 
item halts the process wit the same Skip/Update option as described in 
SEARCH MODE, If a selected record has no target item, then it is deemed to have value 
zero for the purpose af ae the average, Negative numbers are not acceptable, and 
the only non-numeric character allowed is a single decimal point. 


be done from mi or from Displav mode, The result is shown in lines 
y mode, this can be printed. 


ly to totai items of one data reference at a time. For more comple: 
sing one must write some User Basic, q.y. 
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LOAD AND SAVE 


Yse mn VY to initiate a SAVE. A simple menu asks you to choose between F (File only) or 
P (Program and File); or you can back out with ENTER. 


When you select F, the save is in two parts. First. the Basic (which includes the F¢ 
file), then the machine code. You are asked for the save name, upto 1 characters, 
which becomes the name of the Basic component and is displayed in blue in ma. i vou 
press ENTER alone, this is taken to mean “same name as before", The name used for the 
second part of the save is built into the Basic. 


aes you select F, anly character array F# is saved, and the name is solicited as with 


“You may wish to put an automatic VERIFY into line 4020, just before the "60 70 USR 
ise 


YERIFY "" DATA FSO): 
{See BASIC COMMAND MODE for how to access the Basic in order t make this change.) Then 
after a file save, rewind the tape, insert EAR jack, and play the tape. If al! is well. 
an is resumed. Otherwise, 60 10 { and try the save again. 


The file in Ft includes system data. data names, and report formats - as well as your 
file records. 


To load any file which has been saved separately, i.e. via mm VF, y 
must give the exact file name, or back out with ENT! If you forg 
ne aname of XXX and olay the tane, Spectrum will display 
ilename", and you can then BREAK, GO TO 1, and try oer On successful load, 5 
resumed with the new file name and revised statistics. If is mot necessary purge : "ile 
before loading another, since Spectrum wipes out F$ before eet the new Fs, 


AY 57036 
To load MF initially, CLEAR S343 LOAD "" and play any tape which has on it a full 
save (i.e, saved via mi VP). 


We suggest that you keep at least three generations of your ¢ 
or 4 cassettes in rotation. Never make 3 save of the “son” 
since any power interruption would leave you with no file at 


See MICRODRIVE for adaptation to the use of Microdrive cartridges, 
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STATISTICS 


i] an almost constant display of file statistics, in line 23. This clears only 
while text is being keyed. The display consists of... 


The first count is the number of records in the file, and does not include the special 
data names and report format records which share Fé with the file proper. 


The second count is the number of records currently flagged as selected, i.e. eligible 
for display in Display Mode, and eligible for User Basic, Total/Average, etc. Note 
that when records are first created, they are created as "selected". 


The third figure is the approximate number of FAM bytes available for file expansion. 
The figure varies by a small amount depending upon the machine stack, but is a good 
guide to the amount of spare space you have. Any attempt to overflow the file will 
result ina flashing red prompt in the lower part of the screen, "FILE FULL". Press any 
key to resume, but with the last operation aborted. It is recommended that old records 
be purged, or the file split into two files (again via mm P), when spare bytes fall 
below 500 or so. And you will need even more spare space if the file is ever to be 
converted to cartridge. (See MICRODRIVE) 


USER BASIC 


Although MF is a versatile filing system, all it does is hold data, search it, and 
present it, Any processing on the data is done by virtue of you updating individual 
items. But if you are prepared to write some Basic, you can convert MF intoa file 
processor toc, With User Basic you can examine and even update the file. For example, 
suppose you have a file of pupil records, with a series of exam result itens in each 
record. You can compute the average mark for each pupil and store this as an extra iter 
in each record. You may also wish to use User Basic to LPRINT to a non-ZX printer, via 
2 suitable interface. 


user B is given control by am U ¥. Only selected records are passed to User Basic 
for processing, The program as delivered has no User Basic other than a simple return, 
so that m UY has no effect on the file until some extra Basic is inserted. 


When you invoke User Basic ( mm UY >, Basic is given control at specific line numbers, 
as follows... 


Control comes to 4900 just once, before any records are processed. You can 
control point to establish parameters for use at the other points, e.g. INPUT 
a discount rate, or set a switch. As with each control point, you must terminate with a 
G0 TQ USR & statement. 


Control comes here at the start of each selected record, but before any data 
cord is passed, Use this to perform any record initialisation, e.g. zero an 
accumulator. Terminate with GO TO USR F. 


Control comes here once for each item in a selected record. The item is 
. which is a dimensioned character array, legth 120, C#(1) is the data 
(2 10) the data itself, right-filled with spaces. You can 
‘ iadle if you need to use the data later on. Think of line 6000 
as "data caoture’. Terminate with 60 TO USR F. 


17 


Line 7000, Control comes here once for each selected record, after all items have been 
seen at line 6000. Here you can perform processing on the data you captured at line 
5000, and then set up C$ in one of the fcllowing ways... 

a) LET C$="" to signal that no change is to be made to the record. 


b) LET ($="%" - which sets C#(2 10) to blanks - to sicnal that the item whose data 
ref is "X" is to be erased, if present in the record. "X" must be capital A-Z. 


c) LET C$="X" and C#(2 10) = data, to signal that item whose data ref is "*" is to be 
inserted. or replaced if already there, "X" must be capital A-Z. 


Control must be returned to MF proper via 60 70 USR R. 


one pass of 
ral passes, 


Note that only one data item per record can be affected by line 
User Basic. You might be able to arovided multiple item updates 
but this would need some clever use of line 4900 etc. 


The order in which records are passed through User Basic is unsequenced, i.e. the order 
the records were first added to the file. You must not re-dimension Cf, and on no 
account disturb variables F# and R. Be prepared for relatively long delays while User 
Basic processes the file. Completion of User Basic processing is signalled by the 
return of fim. 


Use the technique described in BASIC COMMAND MODE to get into ao 
User Basic. Once it is coded, GD 70 SR 1 to return to mm, Test 
selected records initially. When it works, take a Proc gave via 
you can use it thereafter, 


We finish this chanter with a simple example of 
are records which contain two relevant items, viz "Q" being quantity 
being the unit cost. We require to generate anew item "Y" being th 
computed as the product of Quantity times Unit Cost. (24 0), Furth 
able to recalculate all Value data on demand. It VEry 825Viee 


4900 60 10 USR F 

5000 LET C=O: LET Q=0: 60 TO USR R 

6000 IF C$(1)="0" THEN LET Q=VAL C#{2 TO) 

6010 IF C$(1)="C" THEN LET C=VAL C$(2 TO) 

6020 GO TO USF F 

7000 LET C$="V": LET C#(2 TO)=STRS(QHC): GO TO WSR FR 


Line 4990 has no file initialisation to do, Line ts variables 
case we don’t find data in a record - better a zero value than mi q 
previous record. Line 4000 etc. captures the @ and C items, and also convel 
numeric into variables of the same name - but we could have used any suitable variable 
names, Line. 7000 builds a "V" item and passes it back for insertion or replacement, By 
the way, we avoided the slicker "7000 LET C#="Y"+STR#(,.." because a bug in FROM 
sometimes gives a wrong result with string concatenation, 


would halt 
with 60 10 


In the above example, any non-numeric data in the quanti 
a 


en a Basic diagnostic, For this situation, or 


e 
ny 
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MICRODRIVE 

With a few changes to the Basic part of MF, the abou et will work perfectly with the 
Microdrive. Many users will be able to adapt MF themselves, but for the less conf 

we suggest an adaptation along the following lines. Remember that the Micr 
not give you bigger MF files - just more convenient access. 


Start by loading MASTERFILE from cassette in the normal way, include any User Fasic 
required, and empty the file. Save the machine code by breaking in via mm L and CAPS 
SHIFT 6, and entering without line number... 


SAVE ta" gtz"MF acoderCODE §7544,g192 57037, S497 

Next, alter the lines which contain SAVE and LOAD... 

4020 SAVE H"m";VAL "1°;C$( TO VAL "10") DATA F&: 60 TO USRR 

SAVE ¥"m"sVAL "1"sC$( TO VAL "10") LINE VAL "4035": 60 70 USR F 


4035 LOAD t"m";VAL "1";"MF mcode"CODE: GO TO VAL "1" 
4050 LOAD #"m"sVAL "i"sC$¢ TO VAL "10") DATA F$(): 60 TO USR F 


And now alter line 1... 
{ FRINT :: PAPER YAL "7": GO TO USR VAL "d4951" 


{In case you were wondering...VAL “number” saves 3 RAM bytes compared with 
just...nuaber.) 


60 10 1 and take a save via mm VP etc. - this will save just the Basic, and you need 
not do this again except after revising your User Basic, 


Now. assuming you have earlier saved your files onto cassette via mn YF etc, you must 
now transfer them to cartidge, and we suggest the following little program... 

{0 LOAD "" DATA Fi): INFUT N€: SAVE S"m"s1N# BATA F&O) 

MF modified as described will run entirely using your Microdrive number 1, ang we 
suggest the use of File save rather than Program save, for most purposes. Note that vou 
cannot re-save onto the same cartridge using the same name, 0 we recommend the use ot 
date-stamped names, e.g. "ACCT Augz4". This also helps you to read your CAT directory 
and decide which files are ald enough to be erased, 


You should seriously consider backup of files, either by saying to a different 
cartridge, or copying to cassette as follows... 


10 INPUT N$: LOAD #*m";i;N$ DATA F#(): SAVE N€ DATA F&C) 
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SOME POKES 


To patch the machine code logic cf MF, get into Basic Command Mode, and use PI 
no line numbers. Then 60 TD 1 and take a save via mm Y fF etc. (Or, for Microdriy 
the machine code as described under MICRODRIVE.) 


with 


Here are some p bilities... 
a) If you want more than 26 data references, we can increase the range to allow 0-9 and 
the special characters between ? and A, as follows... 

PIKE 64282,48: PORE 64306,48: POKE 58166, 48 


b) Single-key responses are acknowledged with a low BEEF, whether or 
appropriate. You can POKE your own choice of duration of this BEEF at 
tune the pitch of the BEEP at 57745 (coarsei and 57744 (fine), 


text is being keyed, the PIF note is deliberately more audible than the 
Spectrum default. You can POKE this to taste at 5 ‘ 


Frogran MASTERFILE and this manual are the copyright of Campbell ay 


u 0 tems and may not be 
reproduced, hired, or re-sold without the written consent of Campbell 5; 


SYSTEMS. 


fe allow and expect legitimate users to take back-up copies of the program for their 
own security. - 


CAMPBELL SYSTEMS 
15 Rous Soad, Buckhurst Hill, Essex 169 SBL, England. 
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MASTERF ILE: NEW “MICRO-FRINT FEATURE 


Please note that the number "57245" in oages 6 and 14 should 
now read "37076", and that "S7344, 8192" in page 19 should 
read "57037,8499".. 


Your mar 


you prin 
a 
ation oer 

convention er 


en far ¥ 
een or pe 


In EBIT mode. giving the li & 3 an @lement, 
oromoted with "“Micro-or eoly with the N 
with -pitch, Otherwi cress Yh and then you 


select 42-pi 
wher i 
MF 


“a2-pitch Y/N". Reply ¥ 


noted with 


Roemer 
as you would 
You cam compute 


which can be use any arogram. 


